shaka-player
Advanced tools
Shaka Player is an open-source JavaScript library for adaptive media streaming. It supports DASH and HLS formats and provides a wide range of features for media playback, including DRM support, offline storage, and live streaming.
Basic Playback
This code demonstrates how to set up basic video playback using Shaka Player. It initializes the player with a video element and loads a DASH manifest.
const video = document.getElementById('video');
const player = new shaka.Player(video);
player.load('https://example.com/manifest.mpd').then(function() {
console.log('The video has now been loaded!');
}).catch(function(error) {
console.error('Error loading video', error);
});DRM Support
This code demonstrates how to configure Shaka Player to support DRM (Digital Rights Management). It sets up license servers for Widevine and PlayReady and loads a DASH manifest.
const video = document.getElementById('video');
const player = new shaka.Player(video);
player.configure({
drm: {
servers: {
'com.widevine.alpha': 'https://example.com/widevine_license',
'com.microsoft.playready': 'https://example.com/playready_license'
}
}
});
player.load('https://example.com/manifest.mpd').then(function() {
console.log('The video with DRM has now been loaded!');
}).catch(function(error) {
console.error('Error loading video with DRM', error);
});Offline Storage
This code demonstrates how to use Shaka Player's offline storage feature. It initializes the storage module and stores a DASH manifest for offline playback.
const video = document.getElementById('video');
const player = new shaka.Player(video);
const storage = new shaka.offline.Storage(player);
storage.store('https://example.com/manifest.mpd').then(function(content) {
console.log('The content has been stored offline!', content);
}).catch(function(error) {
console.error('Error storing content offline', error);
});Live Streaming
This code demonstrates how to set up live streaming using Shaka Player. It initializes the player with a video element and loads a live DASH manifest.
const video = document.getElementById('video');
const player = new shaka.Player(video);
player.load('https://example.com/live.mpd').then(function() {
console.log('The live stream has now been loaded!');
}).catch(function(error) {
console.error('Error loading live stream', error);
});Video.js is a popular open-source HTML5 video player that supports a wide range of video formats and provides a plugin architecture for extending its functionality. Compared to Shaka Player, Video.js has a larger community and more plugins available, but it does not natively support DASH or HLS streaming.
Hls.js is a JavaScript library that brings HLS (HTTP Live Streaming) to browsers with support for MSE (Media Source Extensions). It is specifically designed for HLS streaming, whereas Shaka Player supports both DASH and HLS. Hls.js is a good choice if you only need HLS support.
Dash.js is an open-source reference client for the playback of MPEG-DASH content. It is maintained by the DASH Industry Forum and provides extensive support for DASH streaming. Compared to Shaka Player, Dash.js is more focused on DASH and may not have as many features for HLS or DRM.
Shaka Player is an open-source JavaScript library for adaptive media. It plays adaptive media formats (such as DASH and HLS) in a browser, without using plugins or Flash. Instead, Shaka Player uses the open web standards MediaSource Extensions and Encrypted Media Extensions.
Shaka Player also supports offline storage and playback of media using IndexedDB. Content can be stored on any browser. Storage of licenses depends on browser support.
Our main goal is to make it as easy as possible to stream adaptive bitrate video and audio using modern browser technologies. We try to keep the library light, simple, and free from third-party dependencies. Everything you need to build and deploy is in the sources.
For details on what's coming next, see our development roadmap.
See maintained-branches.md for the up-to-date list of maintained branches of Shaka Player.
| Browser | Windows | Mac | Linux | Android | iOS >= 12 | ChromeOS | Other |
|---|---|---|---|---|---|---|---|
| Chrome¹ | Y | Y | Y | Y | Native | Y | - |
| Firefox¹ | Y | Y | Y | untested⁵ | Native | - | - |
| Edge¹ | Y | - | - | - | - | - | - |
| Edge Chromium | Y | Y | Y | untested⁵ | Native | - | - |
| IE | N | - | - | - | - | - | - |
| Safari¹ | - | Y | - | - | iPadOS 13 Native | - | - |
| Opera¹ | untested⁵ | untested⁵ | untested⁵ | untested⁵ | Native | - | - |
| Chromecast² | - | - | - | - | - | - | Y |
| Tizen TV³ | - | - | - | - | - | - | Y |
| WebOS⁶ | - | - | - | - | - | - | Y |
| Xbox One | - | - | - | - | - | - | Y |
| Playstation 4⁷ | - | - | - | - | - | - | Y |
| Playstation 5⁷ | - | - | - | - | - | - | Y |
NOTES:
We support iOS 12+ through Apple's native HLS player. We provide the same
top-level API, but we just set the video's src element to the manifest/media.
So we are dependent on the browser supporting the manifests.
We have another project called Shaka Player Embedded which offers the same features and similar APIs for native apps on iOS. This project uses its own media stack, which allows it to play content that would otherwise not be supported. This supports both DASH and HLS manifests.
| Format | Video On-Demand | Live | Event | In-Progress Recording |
|---|---|---|---|---|
| DASH | Y | Y | - | Y |
| HLS | Y | Y | Y | - |
You can also create a manifest parser plugin to support custom manifest formats.
DASH features supported:
DASH features not supported:
HLS features supported:
HLS features not supported:
| Browser | Widevine | PlayReady | FairPlay | ClearKey⁶ |
|---|---|---|---|---|
| Chrome¹ | Y | - | - | Y |
| Firefox² | Y | - | - | Y |
| Edge³ | - | Y | - | - |
| Edge Chromium | Y | Y | - | Y |
| Safari | - | - | Y | - |
| Opera | untested⁵ | - | - | untested⁵ |
| Chromecast | Y | Y | - | untested⁵ |
| Tizen TV | Y | Y | - | untested⁵ |
| WebOS⁷ | untested⁷ | untested⁷ | - | untested⁷ |
| Xbox One | - | Y | - | - |
| Playstation 4⁷ | - | untested⁷ | - | untested⁷ |
| Playstation 5⁷ | - | untested⁷ | - | untested⁷ |
Other DRM systems should work out of the box if they are interoperable and compliant to the EME spec.
NOTES:
| Manifest | Widevine | PlayReady | FairPlay | ClearKey |
|---|---|---|---|---|
| DASH | Y | Y | - | Y |
| HLS | Y | Y | Y ¹ | - |
NOTES:
Shaka Player supports:
Subtitles are rendered by the browser by default. Applications can create a text display plugin for customer rendering to go beyond browser-supported attributes.
For general help and before filing any bugs, please read the FAQ.
If you have improvements or fixes, we would love to have your contributions. Please read CONTRIBUTING.md for more information on the process we would like contributors to follow.
The Shaka team doesn't have the bandwidth and experience to provide guidance and support for integrating Shaka Player with specific frameworks, but some of our users have successfully done so and created tutorials to help other beginners.
Shaka + ReactJS integrations:
Shaka + Next.js integration:
Shaka + Vue.js integrations:
Shaka + Nuxt.js integration:
Shaka + video.js integration:
Shaka + Angular integration:
If you have published Shaka Integration code/tutorials, please feel free to submit PRs to add them to this list, we will gladly approve!
FAQs
DASH/EME video player library
The npm package shaka-player receives a total of 162,496 weekly downloads. As such, shaka-player popularity was classified as popular.
We found that shaka-player demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Bun 1.2 enhances its JavaScript runtime with 90% Node.js compatibility, built-in S3 and Postgres support, HTML Imports, and faster, cloud-first performance.
Security News
Biden's executive order pushes for AI-driven cybersecurity, software supply chain transparency, and stronger protections for federal and open source systems.
Security News
Fluent Assertions is facing backlash after dropping the Apache license for a commercial model, leaving users blindsided and questioning contributor rights.